Non-
nilmeans, keep buffers created for parsing and lookup. RefTeX sometimes needs to visit files related to the current document. We distinguish files visited forThe created buffers can be kept for later use, or be thrown away immediately after use, depending on the value of this variable:
- PARSING
- Parts of a multifile document loaded when (re)-parsing the document.
- LOOKUP
- BibTeX database files and TeX files loaded to find a reference, to display label context, etc.
nil- Throw away as much as possible.
t- Keep everything.
1- Throw away buffers created for parsing, but keep the ones created for lookup.
If a buffer is to be kept, the file is visited normally (which is potentially slow but will happen only once). If a buffer is to be thrown away, the initialization of the buffer depends upon the variable
reftex-initialize-temporary-buffers.
Non-
nilmeans do initializations even when visiting file temporarily. Whennil, RefTeX may turn off find-file hooks and other stuff to briefly visit a file. Whent, the full default initializations are done (find-file-hooketc.). Instead oftornil, this variable may also be a list of hook functions to do a minimal initialization.
List of regular expressions to exclude certain input files from parsing. If the name of a file included via
\includeor\inputis matched by any of the regular expressions in this list, that file is not parsed by RefTeX.
Non-
nilmeans, re-parse only 1 file when asked to re-parse. Re-parsing is normally requested with a C-u prefix to many RefTeX commands, or with the r key in menus. When this option istin a multifile document, we will only parse the current buffer, or the file associated with the label or section heading near point in a menu. Requesting re-parsing of an entire multifile document then requires a C-u C-u prefix or the capital R key in menus.
Non-
nilmeans, save information gathered with parsing in files. The file MASTER.rel in the same directory as MASTER.tex is used to save the information. When this variable ist,
- accessing the parsing information for the first time in an editing session will read that file (if available) instead of parsing the document.
- exiting Emacs or killing a buffer in reftex-mode will cause a new version of the file to be written.
File extension for the file in which parser information is stored. This extension is added to the base name of the master file.
Non-
nilmeans, RefTeX may rescan the document when this seems necessary. Applies (currently) only in rare cases, when a new label cannot be placed with certainty into the internal label list.
Non-
nilmeans use a separate selection buffer for each label type. These buffers are kept from one selection to the next and need not to be created for each use - so the menu generally comes up faster. The selection buffers will be erased (and therefore updated) automatically when new labels in its category are added. See the variablereftex-auto-update-selection-buffers.
Non-
nilmeans, selection buffers will be updated automatically. When a new label is defined withreftex-label, all selection buffers associated with that label category are emptied, in order to force an update upon next use. Whennil, the buffers are left alone and have to be updated by hand, with the g key from the label selection process. The value of this variable will only have any effect whenreftex-use-multiple-selection-buffersis non-nil.